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Margaret  St.  Pierre,12:37  PM  1 

Date:  Fri,   24  Jun  94  12:37:24  PDT 

To:  protocol-toolkit@wais.com 

From:   saint@wais.com  (Margaret  St.  Pierre) 

Subject:  Current  Status  of  Protocol  Toolkit 

I've  uploaded  the  latest  version  of  the  protocol  work. 

It's  in  " /development/wais-1-1-1-6 . saint . tar . Z" .     Feel  free  to  give  it  a 
spin.  To  run  V2  in  waislookup,  be  sure  to  "set  environment 
connType=Z3950V2 "  in  gdb. 

The  server  will  automatically  distinguish  between  Vl  and  V2  packets. 
The  V2  portion  now  has  most  of  the  basic  functionality,  including: 

-  Client  and  server  can  search  and  get  next  set  of  headlines 

-  Client  and  server  can  do  retrievals,   including  large  documents 

-  Client  and  server  handle  multiple  document  types  of  different  sizes, 

-  Client  now  handles  surrogate  and  non-surrogate  diagnostics . 

-  Client  and  server  both  handle  generic  record  syntax. 

-  No  memory  leaks  in  client;   the  server  has  1  that  I  know  of. 

More  recently,   I've  been  focusing  on  prepping  the  client  code  for  release. 
Things  yet  to  do  next  include : 

-  handle  error  conditions  in  a  uniform  way  (this  is  mostly  there) 

-  fix  the  handling  of  dates  in  backend  and  frontend  (trivial) 

-  somehow  break  the  appConnPduInf o  function  into  two   (one  client,   one  server) 

-  translation  of  WAIS  types  in  Vl  to  media  (MIME)  types  (make  sense  to  do?) 

-  create  a  high-level  program  that  shows  the  use  of  the  toolkit. 

-  document  code,   document  API,   document  high-level  program 

-  Possibly  merge  the  two  development  versions  prior  to  release.  (7) 

-  Add  appropriate  comment  headers  to  all  files  (Brewster) 

I'm  making  every  effort  to  finish  a  Beta  Release  of  the  Client  toolkit  by 
July  1st   (or  possibly  the  following  Tuesday  July  5) . 

The  following  functionality  in  V2  is  not  there  yet.   I'll  work  on  them  after 
the  release  of  the  client  toolkit. 

-  relevance  feedback  in  server   (client  can  already  do  this) 

-  seed  words  used,   and  best  byte   (in  both  client  and  server) 

-  gils  support   (this  may  take  a  while) 

-  server  diagnostics  and  error  handling 

-  waislookup  error  handling 

-  media   (MIME)   types  support 

-  server  handling  of  "F"  and  "B"  element  set  names 

-  handling  of  URL's  in  server 

-  general  code  cleanup  and  documentation  on  server 

-  add  logging  list  the  protocol  used  1988  or  V2 ;  update  waisreporter 


Printed  for  bruce@wais.com  (Bruce  C.  Gilliat) 
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Dear  AppleSearch  Developer: 

You  are  invited  to  a  lunch  hosted  by  the  AppleSearch  team  during  the  Worldwide 
Developer  Conference  on  Thursday,  May  19, 12:30-2:00. 

At  lunch,  we'd  like  to  hear  about  what  you  are  working  on  using  your 
AppleSearch  developer  kit,  ways  we  can  help  you,  and  areas  of  opportunity. 

On  our  end,  through  an  informal  presentation,  we'd  like  to  tell  you  about  some 
of  the  exciting  things  we  are  working  on,  including  AppleSearch  Windows  clients 
and  the  AppleSearch  WAIS  gateway.  We'd  also  like  to  address  the  topic  of  how  we 
can  better  support  and  communicate  with  you. 

If  there  are  specific  topics  you'd  like  to  make  sure  we  cover,  let  us  know. 

Please  R.S.V.P.  to  Denise  Kelley  at  kelley.d(3)applelink.apple.com  or  (408) 
974-2924  by  May  13  if  you  can  join  us  for  lunch.  Denise  will  let  you  know  the 
location.  Make  sure  to  give  your  AppleLink  or  Internet  mail  address  to  Denise  so  we 
can  communicate  with  you  on  line. 

We  really  look  forward  to  seeing  youl 

Best  regards. 


Susan  Gladwin  (gladwin.s)  and  The  AppleSearch  Team 
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